home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmem.z / pmem
Encoding:
Text File  |  2002-10-03  |  8.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmeeeemmmm - report per-process memory usage
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmeeeemmmm [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _p_m_n_s_f_i_l_e] [----SSSS _s_t_a_r_t_t_i_m_e] [----uuuu _u_s_e_r_n_a_m_e]
  13.      [----wwww] [----zzzz] [----ZZZZ _t_i_m_e_z_o_n_e]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmeeeemmmm reports per-process memory usage statistics within the Performance
  17.      Co-Pilot framework.  Both virtual size and pro-rated physical memory
  18.      usage are reported.
  19.  
  20.      Unless directed to another host by the ----hhhh option, ppppmmmmeeeemmmm will contact the
  21.      PMCD (see ppppmmmmccccdddd(1)) on the local host to obtain the required information.
  22.      Alternatively, the ----aaaa option may be used to obtain the required
  23.      information from an archive (see ppppmmmmllllooooggggggggeeeerrrr(1)).  If the ----aaaa option is used,
  24.      then the ----SSSS option may be used to specify the temporal position relative
  25.      to the start of the archive in seconds.
  26.  
  27.      The ----uuuu option restricts the report to the specified _u_s_e_r_n_a_m_e on the
  28.      target host or archive.  Normally the report is truncated at the 80th
  29.      column.  This is over-ridden with the ----wwww option.
  30.  
  31.      By default, ppppmmmmeeeemmmm reports the time of day according to the local timezone
  32.      on the system where ppppmmmmeeeemmmm is run.  The ----ZZZZ option changes the timezone to
  33.      _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as described in
  34.      eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local timezone at
  35.      the host that is the source of the performance metrics, as identified via
  36.      either the ----hhhh or ----aaaa options.
  37.  
  38.      Normally ppppmmmmeeeemmmm operates on the default Performance Metrics Namespace
  39.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  40.      loaded from the file _p_m_n_s_f_i_l_e.
  41.  
  42.      If the PCP product is installed, then the tools ppppssssmmmmoooonnnn(1) and
  43.      mmmmkkkkppppmmmmeeeemmmmaaaarrrrcccchhhh(1) are available to assist in the creation of PCP archives
  44.      that can be replayed with ppppmmmmeeeemmmm(1).
  45.  
  46. RRRREEEEPPPPOOOORRRRTTTT FFFFOOOORRRRMMMMAAAATTTT
  47.      In the report, all sizes are reported in Kbytes unless shown with a
  48.      suffix of MMMM, in which case the size is Mbytes (multiples of 1048576
  49.      bytes), or a suffix of GGGG, in which case the size is Gbytes (multiples of
  50.      1073741824 bytes).  The virtual memory usage statistics represent the
  51.      total virtual size of each process, irrespective of how many pages are
  52.      valid (resident).  The physical memory statistics indicate real memory
  53.      usage (only valid pages are counted) and are pro-rated on a per-page
  54.      basis between all processes which reference each page.
  55.  
  56.      The columns in the report should be interpreted as follows:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      ppppiiiidddd       Process ID.
  75.  
  76.      ppppppppiiiidddd      Parent process ID.
  77.  
  78.      uuuusssseeeerrrrnnnnaaaammmmeeee  User name of process owner.
  79.  
  80.      vvvvttttxxxxtttt      Total virtual memory used by text (executable code) regions
  81.                mapped by the process.
  82.  
  83.      ppppttttxxxxtttt      Pro-rated physical memory used by text regions.
  84.  
  85.      vvvvddddaaaatttt      Total virtual memory used by all non-executable regions,
  86.                excluding shared memory regions.  This includes initialized
  87.                data, bss and stack but not shared memory regions.
  88.  
  89.      ppppddddaaaatttt      Pro-rated physical memory used by all data regions (data, bss
  90.                and stack but not shared memory regions).
  91.  
  92.      vvvvsssshhhhmmmm      Total virtual memory used by all shared memory regions.
  93.  
  94.      ppppsssshhhhmmmm      Pro-rated physical memory used by shared memory regions.
  95.  
  96.      ccccoooommmmmmmmaaaannnndddd   The command and arguments, truncated so each line in the report
  97.                is at most 80 columns (unless the ----wwww option is given).
  98.  
  99.      The report heading shows the amount of physical memory configured on the
  100.      target host and the amount of free memory, as reported by the operating
  101.      system (see the PCP metric mmmmeeeemmmm....ffffrrrreeeeeeeemmmmeeeemmmm).
  102.  
  103.      Only memory used in user space is counted - memory used in kernel tables
  104.      such as that used for pppptttteeees (page table entries), and the pppprrrroooocccc and uuuusssseeeerrrr
  105.      structures are not counted because they are allocated in the kernel's
  106.      address space.
  107.  
  108.      If any shared memory segments are found with no process attachment, the
  109.      size of these are summed.  If the total is more than 4096 bytes, then
  110.      this is reported as vvvvsssshhhhmmmm belonging to a virtual process with a ccccoooommmmmmmmaaaannnndddd of
  111.      ``orphaned shmem'' and a ppppiiiidddd of ``???''.
  112.  
  113.      At the end of the report, a summary is printed indicating the totals for
  114.      each column and the grand totals.  The difference between the total
  115.      physical memory in use by all processes and the total configured physical
  116.      memory will always be more than the free memory reported by the operating
  117.      system because the latter also accounts for memory allocated in the
  118.      kernels address space.
  119.  
  120.      All statistics are accurate to within one 256th of a page.
  121.  
  122. FFFFIIIILLLLEEEESSSS
  123.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss////*
  124.                default PMNS specification files
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  137.  
  138.  
  139.  
  140. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  141.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  142.      file and directory names used by PCP.  On each installation, the file
  143.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  144.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  145.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  146.  
  147. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  148.      mmmmkkkkppppmmmmeeeemmmmaaaarrrrcccchhhh(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1),
  149.      ppppmmmmvvvvaaaallll(1) and sssspppprrrroooocccc(2).
  150.  
  151. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  152.      All are generated on standard error and are intended to be self-
  153.      explanatory.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.